home *** CD-ROM | disk | FTP | other *** search
/ Disc to the Future 2 / Disc to the Future Part II Programmer's Reference (Wayzata Technology)(6013)(1992).bin / MAC / HYPERCAR / FLASHXCM / README
Text File  |  1992-02-26  |  2KB  |  30 lines

  1. This package contains three files (beside this one).
  2.  
  3. "FlashXCMD.c"  -  essentially identical the XCMD example "Flash" for MPW C described in "HyperCard Script Language Guide" p. 489.
  4.  
  5. "FlashXCMD.make" - the makefile for this compile. This can be used as a generic makefile for XCMDs and XFCNs and should be easily adaptible to your needs.
  6.  
  7. "TestStack" is a tiny HyperCard demo stack containing a single button which executes the XCMD.
  8.  
  9.  
  10. ABOUT THE MAKEFILE:
  11.  
  12. In makefiles, structures of the form:
  13.           SomeWord = xxxx  yyyy
  14. create a script variable much like #define in C. The variable can thereafter be referred to by enclosing in brackets, {SomeWord}.  Most of the parameters for Link and C tools have been put in this form.
  15.                
  16. The "Name" should be the identical procedure name you will use in your HyperCard script; it must not contain any spaces.  It is also the name of the various files.
  17.  
  18. The makefile will compile the XCMD and then insert it directly into your target HyperCard stack, named in {Stack}. The stack should be in the same (current) folder. Any prior XCMD/XFCN resource of the same ID number will be replaced.  This is very convenient and eliminates having to use ResEdit or some other program to transfer the resource.
  19.  
  20. If, however, {Stack} does not exist, then the compiler will create a new file of that name and put your resource into it. The Type and Creator of the file will be    'STAK' and 'WILD', respectively, so in the Finder it will look like a HyperCard stack, but brother it ain't; it's just an isolated resource in an otherwise empty file.
  21.  
  22. If you really want to compile your XCMD or XFCN to an isolated resource file, then change the Type and Creator in the Linker options, {LOptions}, to
  23.            -t rsrc
  24.            -c RSED
  25. The resulting file will be a ResEdit document with the "Jack-in-the-Box" icon.
  26.  
  27. This is FreeWare.. I hope it's useful.
  28.  
  29. John Jeppson
  30. CIS  76174,2007